[3.x] [tvOS] Basic tvOS Support #45829

naithar · 2021-02-08T16:16:19Z

Added basic tvOS support.
Implements already closed but not implemented proposal: godotengine/godot-proposals#224

Platform code is based on iOS platform code with minor changes (some iOS stuff isn't available on tvOS).
Audio interruption was also removed - AppleTV don't seem post interruption notification correctly or in right order, which results in game freezing after application loses focus.
Keyboard input backed was changed so keyboard input actually works.
Input is handled by controllers. Apple/Siri Remote are also considered controller (micro)

Export code (including plugins) is also based on iOS platform since both of them export into Xcode project.
But export is also simpler:

Launch screen is storyboard based (no need for launch images)
tvOS project supports empty Apple Team ID
Icons, Signatures and certificates are handled by Xcode project

Core code has been modified to address tvOS unsupported features - no fork and execvp.
Rendering code has been modified for tvOS to use same paths/methods as iOS's.

Mono haven't been ported.
GDNative uses same configuration as iOS platform.

Exports correctly
Runs correctly
Handles input
Plugins support (example https://github.com/naithar/godot-ios-plugins/tree/feature/tvos-support)
GDNative support (tvOS support godot-headers#85 Support tvOS compilation godot-cpp#512)
App Store upload

Build container and script PRs: godotengine/build-containers#71, godotengine/godot-build-scripts#21

Since linux-compiled binaries are required to use use_lto to pass App Store checks, I'll place macOS built tvOS templates and binaries here: unofficial tvOS templates

modules/gdnative/register_types.cpp

touilleMan

⚠️ I only reviewed the gdnative part of this PR (and it seems pretty fine for me 😄 )

Added delay for 'end' press. This should allow to use Input.is_joy_button_pressed with JOY_START. Added separate tvOS delay settings in project settings. Added 'tvOS.overrides_menu_button' value. This allows to enable system's default processing of menu button.

naithar · 2021-06-17T12:41:29Z

Reverting this PR (as well as one for master branch) back to draft for now.
I'm working on simplifying code sharing between UIKit based platforms - iOS and tvOS. Progress is here: naithar@4c30d17

It's working, but I'm not happy with the overall code structure/cleanliness for now.

paulocoutinhox · 2021-09-15T06:06:23Z

Hi,

Any news when it will be available?

Valeryn4 · 2022-01-19T16:04:49Z

Good day! There was a need for tvOS
Is it enough just to merge into the 3.4 branch?

Calinou · 2022-01-19T17:24:56Z

Good day! There was a need for tvOS Is it enough just to merge into the 3.4 branch?

This won't be merged in 3.4.x as patch releases are now dedicated to bug fixes only. This can be merged for 3.5 if this is rebased against the latest 3.x branch and tested again.

paulocoutinhox · 2022-01-19T17:53:22Z

Good day! There was a need for tvOS Is it enough just to merge into the 3.4 branch?

This won't be merged in 3.4.x as patch releases are now dedicated to bug fixes only. This can be merged for 3.5 if this is rebased against the latest 3.x branch and tested again.

@naithar Can you rebase?

Valeryn4 · 2022-01-19T22:35:19Z

Good day! There was a need for tvOS Is it enough just to merge into the 3.4 branch?

This won't be merged in 3.4.x as patch releases are now dedicated to bug fixes only. This can be merged for 3.5 if this is rebased against the latest 3.x branch and tested again.

It was a question to the author of a branch.
I was unable to build a template for the emulator.
Also, the version worries me about the presence of errors in 3.4.beta.
Tomorrow I will try to merge locally with my branch 3.4. I will do this blindly. Without any understanding of the template device.

naithar · 2022-01-20T13:13:44Z

Good day! There was a need for tvOS

Is it enough just to merge into the 3.4 branch?

I'm planning to work on this PR and some other iOS issues, but I can't really give a time frame for when it will be ready.

You should be able to use this version of PR after some modifications, but I can't name them as I haven't been following development for some time.

Valeryn4 · 2022-01-24T05:22:17Z

problem control...
remote control uses axes for dpad

I added this to my dpad block.
Otherwise, it is not possible to make smooth control of the remote control.
The second generation console always uses two vectors.
Therefore, counting the pressure is meaningless. If we want to emulate dpad clicks, we need to read vectors.
It is also necessary to enter deadzone.

Try dpad control in a 2D game. be surprised)

InputDefault::JoyAxis jx = {-1, gamepad.dpad.xAxis.value};
InputDefault::JoyAxis jy = {-1, -gamepad.dpad.yAxis.value}; //inverse y

OSAppleTV::get_singleton()->joy_axis(joy_id, JOY_AXIS_8, jx);
OSAppleTV::get_singleton()->joy_axis(joy_id, JOY_AXIS_9, jy);

//if axis over deadzone -0.5-0.5 - pressed button
if (jx.value < -0.5)
    OSAppleTV::get_singleton()->joy_button(joy_id, JOY_DPAD_LEFT, gamepad.dpad.left.isPressed);
elif (jx.value > 0.5)
    OSAppleTV::get_singleton()->joy_button(joy_id, JOY_DPAD_RIGHT, gamepad.dpad.left.isPressed);

Valeryn4 · 2022-01-26T02:09:58Z

tvOS unsupport NSDocumentDirectory directory.
tvOS prevents writing out of cache or NSUserDefaults

Need use NSUserDefaults (512kb limit)
Need use NSCachesDirectory

naithar · 2022-03-10T08:42:16Z

Superseded by #58976 and #58977

paulocoutinhox · 2025-10-24T00:27:58Z

Guys,

Nice work.

@rsanchezsaez There is any guy in Apple team to add the AppleTV support?

Im waiting for AppleTV for years.

I want migrate to Godot but my games runs on AppleTV:

https://apps.apple.com/app/game-mania-world/id6504422874

naithar mentioned this pull request Feb 8, 2021

[4.0] [tvOS] Basic tvOS Support #45830

Closed

naithar force-pushed the feature/apple-tv branch 3 times, most recently from 9e68457 to a5ea4e3 Compare February 9, 2021 08:17

Chaosus added feature proposal topic:platforms labels Feb 9, 2021

Chaosus added this to the 3.2 milestone Feb 9, 2021

naithar force-pushed the feature/apple-tv branch 4 times, most recently from 7b6f939 to ee5b064 Compare February 12, 2021 11:44

This was referenced Feb 12, 2021

tvOS build support godotengine/godot-build-scripts#21

Open

tvOS build support godotengine/build-containers#71

Open

Support tvOS compilation godotengine/godot-cpp#512

Open

naithar force-pushed the feature/apple-tv branch 4 times, most recently from 0756c49 to 77e4b4a Compare February 19, 2021 14:03

naithar marked this pull request as ready for review February 19, 2021 19:38

naithar requested review from a team as code owners February 19, 2021 19:38

touilleMan reviewed Feb 19, 2021

View reviewed changes

modules/gdnative/register_types.cpp Outdated Show resolved Hide resolved

naithar force-pushed the feature/apple-tv branch from 77e4b4a to 8c7c5b5 Compare February 20, 2021 16:53

naithar requested a review from a team as a code owner February 20, 2021 16:53

This was referenced Feb 20, 2021

Project export for iOS takes a very long time (10+ min) due to LTO enabled in 3.2.4 RC 2 #46064

Closed

Add a method to detect whether a mobile project is running on a TV (Fire TV, tvOS, …) godotengine/godot-proposals#2300

Closed

touilleMan approved these changes Feb 23, 2021

View reviewed changes

naithar added 4 commits April 1, 2021 23:17

[tvOS] tvOS export

d25cb36

[CI] tvOS workflow

92e1a71

[tvOS] GDNative support

146c934

naithar force-pushed the feature/apple-tv branch from f233b70 to 881b653 Compare April 1, 2021 20:17

akien-mga requested a review from a team May 7, 2021 07:46

naithar marked this pull request as draft June 17, 2021 12:37

akien-mga changed the title ~~[3.4] [tvOS] Basic tvOS Support~~ [3.x] [tvOS] Basic tvOS Support Oct 5, 2021

akien-mga modified the milestones: 3.4, 3.5 Oct 5, 2021

akien-mga force-pushed the 3.x branch 2 times, most recently from 71cb8d3 to c58391c Compare January 6, 2022 22:40

This was referenced Mar 10, 2022

[3.x] [tvOS] tvOS Support #58976

Closed

[4.0] [tvOS] tvOS Support #58977

Closed

naithar closed this Mar 10, 2022

akien-mga added archived platform:ios labels Mar 10, 2022

akien-mga mentioned this pull request May 15, 2025

Native visionOS platform support #105628

Merged

AThousandShips removed this from the 3.5 milestone Oct 24, 2025

Uh oh!

[3.x] [tvOS] Basic tvOS Support #45829

[3.x] [tvOS] Basic tvOS Support #45829

Uh oh!

Conversation

naithar commented Feb 8, 2021 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

touilleMan left a comment

Choose a reason for hiding this comment

Uh oh!

naithar commented Jun 17, 2021

Uh oh!

paulocoutinhox commented Sep 15, 2021

Uh oh!

Valeryn4 commented Jan 19, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Calinou commented Jan 19, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

paulocoutinhox commented Jan 19, 2022

Uh oh!

Valeryn4 commented Jan 19, 2022

Uh oh!

naithar commented Jan 20, 2022

Uh oh!

Valeryn4 commented Jan 24, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Valeryn4 commented Jan 26, 2022

Uh oh!

naithar commented Mar 10, 2022

Uh oh!

paulocoutinhox commented Oct 24, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

9 participants

naithar commented Feb 8, 2021 •

edited

Loading

Valeryn4 commented Jan 19, 2022 •

edited

Loading

Calinou commented Jan 19, 2022 •

edited

Loading

Valeryn4 commented Jan 24, 2022 •

edited

Loading